Array.join()

Доступность

Flash Player 5.

Синтаксис

my_array.join([separator:String]) : String

Параметры

separator Символ или строка, которая будет отделять друг от друга элементы массива в возвращаемой строке. Если разделитель не указан, по умолчанию будет использоваться запятая (,).

Возвращает

Строка

Описание

Метод; преобразует элементы массива в строки (Strings), вставляет и определяет разделитель между элементами, связывает их и возвращает строковый результат. Вложенный массив всегда разделяется запятой (,), а не разделителем, указанный в круглых скобках метода join().

Пример

В следующем примере создаётся массив с тремя элементами: Earth, Moon, и Sun. Далее происходит соединение элементов массива тремя разными способами — в первом используется разделитель по умолчанию(запятая [,] и пробел), во втором используется тире (-), в третьем знак плюс (+) :

var a_array:Array = new Array("Earth","Moon","Sun")
trace(a_array.join()); 
// выводится Earth,Moon,Sun
trace(a_array.join(" - ")); 
// выводится Earth - Moon - Sun
trace(a_array.join(" + ")); 
// выводится Earth + Moon + Sun

Далее пример, создания массива, содержащего два вложенных массива. Первый массив имеет три элемента: Europa, Io, и Callisto. Второй имеет два элемента: Titan и Rhea. Связывание элементов массива происходит с использованием, в качестве разделителя, знака плюс (+), при этом элементы вложенных массивов разделяются запятой (,).

var a_nested_array:Array = new Array(["Europa", "Io", "Callisto"], ["Titan", "Rhea"]);
trace(a_nested_array.join(" + "));
// возвращает Europa,Io,Callisto + Titan,Rhea

См.также

String.split()